Integration Surfaces
CYO applications integrate into the Candescent Digital Banking platform at specific surfaces — predefined regions where FI-hosted content is loaded and authenticated via SAML SSO.
Surface Catalog
| Surface | Platform behavior | Configuration path |
|---|---|---|
| CYO widget (stack card) | Iframe embedded as a card in the OLB widget stack | Experience Groups → Modern Widgets; Layout Option = Stack |
| CYO widget (standalone) | Iframe rendered as a standalone page widget | Experience Groups → Modern Widgets; Layout Option = Standalone |
| Hosted page (new window) | Application launched in a separate browser window with SAML SSO | Configured outside the widget stack; requires SAML connectivity via Fintech Integrations |
| Mobile CYO | FI-hosted content surfaced in the mobile banking session | SAML SSO–backed; PDF and download behavior depends on CYO app configuration — see Technical Reference |
info
CYO widgets are created by selecting Yes for "Load Widget in IFrame?" when adding a Modern Widget. Non-iframe widgets follow a different integration model — see Widgets.
CYO Widget Layout Options
When configuring a CYO widget, the Layout Option determines where the iframe appears:
| Layout option | Placement | Typical use |
|---|---|---|
| Stack | Card in the homepage widget stack | Dashboard-style tools, summaries, and compact FI applications |
| Standalone | Dedicated widget page outside the stack | Full-page FI experiences that need more horizontal space |
Sizing Constraints by Layout
| Layout | Width behavior | Default height |
|---|---|---|
| Stack (2-column page) | ~4/12 of page width (roughly 350px – 465px) | 600px |
| Stack (1-column page) | Up to ~1150px, scales with viewport | 600px |
| Standalone | Full widget page width | 600px |
Use iframeResizer scripts in the CYO application to adjust height dynamically — see Technical Reference.
Widget Configuration Fields
Each CYO widget surface is defined by these fields in Experience Groups:
| Field | Purpose |
|---|---|
| Widget Name | Admin-visible name; default end-user title |
| URL | HTTPS endpoint hosted by the FI or vendor |
| Layout Option | Stack card or standalone page |
| Load Widget in IFrame? | Must be Yes for CYO-style iframe widgets |
After saving, place and activate the widget in the Web Builder, then publish the experience.
How to Choose a Surface
| Requirement | Recommended surface |
|---|---|
| Compact tool on the OLB homepage | CYO widget — Stack |
| Full-page FI application within OLB | CYO widget — Standalone |
| Application that must open outside the banking shell | Hosted page (new window) |
| Mobile banking session with FI-hosted content | Mobile CYO (SAML SSO) |
Next Steps
- Getting Started — Create and publish a CYO widget
- Capabilities — Platform features and admin permissions
- Technical Reference — Header overrides, iframe resizing, and troubleshooting